Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add documentation to the macrocache module #17431

Merged
merged 8 commits into from Mar 21, 2021
Merged

Add documentation to the macrocache module #17431

merged 8 commits into from Mar 21, 2021

Conversation

ghost
Copy link

@ghost ghost commented Mar 20, 2021

The old wording was unclear, also there were no code examples.

One thing which I'm still not sure of is how we can show the usage in different modules.
Create a code block example with multiple files, or is the text enough?

Also, I had to name caches of the same type differently because runnableExamples compiles them from a single file so that their content will be shared if they have the same name.

Closes #14889

@ghost ghost requested a review from timotheecour March 20, 2021 23:09
doc/lib.rst Outdated Show resolved Hide resolved
lib/core/macrocache.nim Outdated Show resolved Hide resolved
Danil Yarantsev and others added 2 commits March 21, 2021 04:19
Co-authored-by: konsumlamm <44230978+konsumlamm@users.noreply.github.com>
@ghost ghost requested a review from timotheecour March 21, 2021 05:42
@ghost ghost marked this pull request as ready for review March 21, 2021 05:43
@Araq Araq merged commit c5b1092 into nim-lang:devel Mar 21, 2021
ringabout pushed a commit to ringabout/Nim that referenced this pull request Mar 22, 2021
* Add docs to macrocache

* use hint

* Use incl in the incl example

* add macrocache to lib

* consistency

* Update doc/lib.rst

Co-authored-by: konsumlamm <44230978+konsumlamm@users.noreply.github.com>

* apply suggestions

* clarify the warning

Co-authored-by: konsumlamm <44230978+konsumlamm@users.noreply.github.com>
ardek66 pushed a commit to ardek66/Nim that referenced this pull request Mar 26, 2021
* Add docs to macrocache

* use hint

* Use incl in the incl example

* add macrocache to lib

* consistency

* Update doc/lib.rst

Co-authored-by: konsumlamm <44230978+konsumlamm@users.noreply.github.com>

* apply suggestions

* clarify the warning

Co-authored-by: konsumlamm <44230978+konsumlamm@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Documentation macrocache status is confusing
3 participants